Skip to content

fix: Workflow de preview de documentação falha em PRs de fork#97

Merged
camilamaia merged 4 commits intocumbucadev:mainfrom
lele-sf:93
Apr 22, 2026
Merged

fix: Workflow de preview de documentação falha em PRs de fork#97
camilamaia merged 4 commits intocumbucadev:mainfrom
lele-sf:93

Conversation

@lele-sf
Copy link
Copy Markdown
Contributor

@lele-sf lele-sf commented Apr 12, 2026

O que foi alterado

O workflow de preview da documentação foi dividido em dois:

  • deploy-preview-documentation.yml: faz o build, salva o número do PR como artifact e continua publicando o preview apenas para PRs internos.
  • comment-preview-documentation.yml: novo workflow responsável por comentar no PR após o build, usando workflow_run.

O comentário agora é adaptado à origem do PR:

  • PR interno: mostra o link do preview
  • PR de fork: mostra como baixar o artifact

Além disso, a lógica de comentário continua atualizando o comentário existente em vez de criar vários.

Motivo da mudança

PRs de forks recebem um GITHUB_TOKEN com permissões limitadas. Isso fazia o deploy para gh-pages falhar e também impedia o comentário no PR com erro 403.

Separar o fluxo em dois workflows segue o padrão recomendado para esse cenário: o pull_request faz apenas o processamento seguro do PR, e o workflow_run faz a etapa que precisa de escrita no PR.

Issue relacionada

Resolve #93

Referência

@lele-sf lele-sf self-assigned this Apr 12, 2026
@lele-sf lele-sf requested review from a team as code owners April 12, 2026 21:08
Copy link
Copy Markdown
Member

@camilamaia camilamaia left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Boaaa, ficou ótimo dividir em dois workflows! Vc conseguiu testar no PR para ver se funciona?

@lele-sf
Copy link
Copy Markdown
Contributor Author

lele-sf commented Apr 21, 2026

Boaaa, ficou ótimo dividir em dois workflows! Vc conseguiu testar no PR para ver se funciona?

Ah, eu devia ter comentado isso na PR antes😅

Consegui testar parcialmente, o build e os artifacts funcionaram certinho no PR do fork. Mas o comentário não apareceu, workflows disparados por workflow_run só rodam se o arquivo já existir na branch main. Como o comment-preview-documentation.yml ainda está só nessa branch, ele não é disparado.

Então imagino que essa parte só dá pra validar depois do merge, com um PR interno.

https://docs.github.com/pt/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_run

@camilamaia
Copy link
Copy Markdown
Member

Ahh faz todo sentido! Daria para gente fazer um workflow dispatch para poder acionar manualmente, mas acho que para esse caso é mais fácil testar direto no main mesmo, já que n tem nenhuma implicação grande se não funfar.

Bora dale então!

@camilamaia camilamaia merged commit b8f8cd5 into cumbucadev:main Apr 22, 2026
1 check passed
@lele-sf lele-sf deleted the 93 branch April 22, 2026 19:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Fix: Workflow de preview de documentação falha em PRs de fork

2 participants